home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / OpenGL / opengldoc / glspec / depth_texture.spec < prev    next >
Encoding:
Text File  |  1996-11-11  |  5.3 KB  |  163 lines
  1. XXX - Not complete yet!!!
  2.  
  3. Name
  4.  
  5.     SGIS_depth_texture
  6.  
  7. Name Strings
  8.  
  9.     GL_SGIS_depth_texture
  10.  
  11. Version
  12.  
  13.     $Date: 1996/04/01 23:22:37 $ $Revision: 1.1 $
  14.  
  15. Number
  16.  
  17.     63
  18.  
  19. Dependencies
  20.  
  21.     EXT_texture is required
  22.     EXT_texture3D is required
  23.     EXT_subtexture affects the definition of this extension
  24.     EXT_copy_texture affects the definition of this extension
  25.  
  26. Overview
  27.  
  28.     This extension defines a new depth texture format.  An important
  29.     application of depth texture images is shadow casting, but separating
  30.     this from the shadow extension allows for the potential use of depth
  31.     textures in other applications such as displacement mapping or 2 1/2D
  32.     rendering.  Typically one or more depth images are computed in the
  33.     framebuffer, then copied into texture memory and used to control
  34.     shading.
  35.     
  36. New Procedures and Functions
  37.  
  38.     None
  39.  
  40. New Tokens
  41.  
  42.     Accepted by the <components> parameters of TexImage1D and TexImage2D,
  43.     and by the <internalformat> parameters of TexImage3DEXT,
  44.     CopyTexImage1DEXT, and CopyTexImage2DEXT:
  45.  
  46.     GL_DEPTH_COMPONENT12_SGIS
  47.     GL_DEPTH_COMPONENT16_SGIS
  48.     GL_DEPTH_COMPONENT24_SGIS
  49.     GL_DEPTH_COMPONENT32_SGIS
  50.  
  51.  
  52. Additions to Chapter 2 of the 1.0 Specification (OpenGL Operation)
  53.  
  54.     None
  55.  
  56. Additions to Chapter 3 of the 1.0 Specification (Rasterization)
  57.  
  58.     XXX - lots
  59.  
  60.     Notes:
  61.  
  62.     *    Defines GL_DEPTH_COMPONENTS as a new base internal format for
  63.     textures.  Defines 12, 16, 24, and 32 bit specific internal formats
  64.     for texture.  Just as for the specific color internal formats,
  65.     an implementation can choose whether to implement them or not.
  66.  
  67.     *    Texture commands that accept images from memory now allow the
  68.     internal format to be GL_DEPTH_COMPONENTS or GL_DEPTH_COMPONENTS*_SGI
  69.     when the format of the image data is GL_DEPTH_COMPONENTS.  Depth, not
  70.     color pixel transfer operations are applied to depth images.
  71.  
  72.     *    Texture commands that accept images from the framebuffer now take
  73.     their data from the depth buffer when the internal format is
  74.     GL_DEPTH_COMPONENTS or GL_DEPTH_COMPONENTS*_SGI, or when no internal
  75.     format is specified, and the internal format of the target texture
  76.     is GL_DEPTH_COMPONENTS or GL_DEPTH_COMPONENTS*_SGI.
  77.  
  78. Additions to Chapter 4 of the 1.0 Specification (Per-Fragment Operations
  79. and the Frame Buffer)
  80.  
  81.     None
  82.  
  83. Additions to Chapter 5 of the 1.0 Specification (Special Functions)
  84.  
  85.     None
  86.  
  87. Additions to Chapter 6 of the 1.0 Specification (State and State Requests)
  88.  
  89.     None
  90.  
  91. Additions to the GLX Specification
  92.  
  93.     None
  94.  
  95. Dependencies on EXT_texture
  96.  
  97.     EXT_texture is required.
  98.  
  99. Dependencies on EXT_texture3D
  100.  
  101.     EXT_texture3D is not required, but if it is not supported, the
  102.     implementation must compute the R texture coordinate as if it were.
  103.     If EXT_texture3D is not supported, references to TexImage3DEXT and
  104.     TexSubImage3DEXT in this document are invalid and should be ignored.
  105.  
  106. Dependencies on EXT_subtexture
  107.  
  108.     If EXT_subtexture is not supported, references to TexSubImage1DEXT,
  109.     TexSubImage2DEXT, and TexSubImage3DEXT in this document are invalid and
  110.     should be ignored.  If EXT_subtexture is supported, the operations of
  111.     these three commands are affected by this extension.
  112.  
  113. Dependencies on EXT_copy_texture
  114.  
  115.     If EXT_copy_texture is not supported, references to CopyTexImage1DEXT
  116.     and CopyTexImage2DEXT in this document are invalid and should be
  117.     ignored.  If EXT_copy_texture is supported, the operations of these two
  118.     commands, and of CopyTexSubImage1DEXT, CopyTexSubImage2DEXT, and
  119.     CopyTexSubImage3DEXT are affected by this extension.
  120.  
  121. Errors
  122.  
  123.     INVALID_OPERATION is generated if TexImage1D or TexImage2D parameter
  124.     <format> is GL_DEPTH_COMPONENT and parameter <components> is not
  125.     GL_DEPTH_COMPONENT, GL_DEPTH_COMPONENT12_SGI, GL_DEPTH_COMPONENT16_SGI,
  126.     GL_DEPTH_COMPONENT24_SGI, or GL_DEPTH_COMPONENT32_SGI.
  127.  
  128.     INVALID_OPERATION is generated if TexImage1D or TexImage2D parameter
  129.     <components> is GL_DEPTH_COMPONENT, GL_DEPTH_COMPONENT12_SGI,
  130.     GL_DEPTH_COMPONENT16_SGI, GL_DEPTH_COMPONENT24_SGI, or
  131.     GL_DEPTH_COMPONENT32_SGI, and parameter <format> is not
  132.     GL_DEPTH_COMPONENT.
  133.  
  134.     INVALID_OPERATION is generated if TexImage3DEXT parameter <format> is
  135.     GL_DEPTH_COMPONENT and parameter <internalformat> is not
  136.     GL_DEPTH_COMPONENT, GL_DEPTH_COMPONENT12_SGI, GL_DEPTH_COMPONENT16_SGI,
  137.     GL_DEPTH_COMPONENT24_SGI, or GL_DEPTH_COMPONENT32_SGI.
  138.  
  139.     INVALID_OPERATION is generated if TexImage3DEXT parameter <internalformat>
  140.     is GL_DEPTH_COMPONENT, GL_DEPTH_COMPONENT12_SGI, GL_DEPTH_COMPONENT16_SGI,
  141.     GL_DEPTH_COMPONENT24_SGI, or GL_DEPTH_COMPONENT32_SGI, and parameter
  142.     <format> is not GL_DEPTH_COMPONENT,
  143.  
  144.     INVALID_OPERATION is generated if CopyTexImage1DEXT or CopyTexImage2DEXT
  145.     parameter <internalformat> is GL_DEPTH_COMPONENT,
  146.     GL_DEPTH_COMPONENT12_SGI, GL_DEPTH_COMPONENT16_SGI,
  147.     GL_DEPTH_COMPONENT24_SGI, or GL_DEPTH_COMPONENT32_SGI, and there is no
  148.     depth buffer.
  149.  
  150.     INVALID_OPERATION is generated if CopyTexSubImage1DEXT,
  151.     CopyTexSubImage2DEXT, or CopyTexSubImage3DEXT is called while the <target>
  152.     texture has internal format GL_DEPTH_COMPONENT, GL_DEPTH_COMPONENT12_SGI,
  153.     GL_DEPTH_COMPONENT16_SGI, GL_DEPTH_COMPONENT24_SGI, or
  154.     GL_DEPTH_COMPONENT32_SGI, and there is no depth buffer.
  155.  
  156. New State
  157.  
  158.     None
  159.  
  160. New Implementation Dependent State
  161.  
  162.     None
  163.